Summary

This PR fixes all test failures and adds significant improvements to the pyandroid-dev library for version 1.4.0.

Critical Fixes

✅ Test Workflow Fixed

• Fixed coverage XML generation in GitHub Actions
• Tests now pass successfully in CI
• Added --cov-report=xml and --cov-report=term flags
• Limited codecov upload to Python 3.11 only

✅ Backend Import Error Handling

• Fixed crash when Kivy is not installed
• Backend module now gracefully handles missing Kivy
• Console-only mode works without Kivy dependency

✅ Activity Lifecycle Validation

• Added state transition validation
• Prevents invalid lifecycle transitions
• Raises InvalidStateError for invalid operations

New Features

🎯 Custom Exception Classes

• PyAndroidError - Base exception class
• ActivityNotFoundError - Activity not registered
• InvalidStateError - Invalid state transitions

🎯 Enhanced Type Hints

• Comprehensive type hints throughout core.py
• Better IDE autocomplete support
• Improved static analysis

🎯 Activity Extras

• Activities can accept kwargs during initialization
• Extras stored in activity.extras dictionary
• Useful for passing data between activities

🎯 Intent Improvements

• has_extra(key) - Check if extra exists
• get_all_extras() - Get all extras as dictionary

🎯 View Management

• Added remove_view() method to Activity class

Code Quality Improvements

📝 Documentation

• Added comprehensive docstring examples
• Better parameter descriptions
• Usage examples for all major classes

🧪 Test Suite Enhancements

• Added pytest fixtures for test objects
• 90+ total test cases (up from ~20)
• Added tests for exceptions and edge cases
• Created conftest.py for shared configuration
• Reduced test code duplication

🔧 Better Error Messages

• More informative error messages with context
• Suggest available options when errors occur

Configuration Updates

• ❌ Dropped Python 3.7 support (EOL)
• ✅ Updated to Python 3.8+ only
• 📦 Updated pyproject.toml to version 1.4.0
• 🏷️ Added "Typing :: Typed" classifier
• ⚙️ Improved test configuration

Breaking Changes

⚠️ Python 3.7 is no longer supported - Users must upgrade to Python 3.8+

⚠️ Activity lifecycle now validated - Code with invalid state transitions will raise InvalidStateError

Testing

All tests now pass:

pytest --cov=pyandroid --cov-report=xml --cov-report=term tests/

Files Changed

• .github/workflows/tests.yml - Fixed coverage generation
• pyandroid/backend/__init__.py - Graceful import error handling
• pyandroid/core.py - Major improvements (exceptions, validation, type hints)
• tests/test_core.py - Comprehensive test improvements
• tests/test_ui.py - Additional UI component tests
• tests/conftest.py - New shared test configuration
• pyproject.toml - Updated metadata and Python version
• IMPROVEMENTS.md - Full documentation of changes

Documentation

See IMPROVEMENTS.md for detailed documentation of all changes, migration guide, and examples.

Checklist

• Tests pass locally
• Tests pass in CI
• Code follows project style
• Documentation updated
• Version bumped to 1.4.0
• Breaking changes documented
• Migration guide provided

Next Steps

After merging:

1. Tag release as v1.4.0
2. Publish to PyPI
3. Update main README if needed

Ready to merge! This PR significantly improves the library's reliability, maintainability, and developer experience.